package com.yunxi.module.system.service.auth;

import com.yunxi.module.system.vo.admin.auth.AuthLoginReqVO;
import com.yunxi.module.system.vo.admin.auth.AuthLoginRespVO;
import com.yunxi.module.system.model.user.AdminUserDO;

/**
 * <p>
 * 管理后台的认证 Service 接口
 * </p>
 * 提供用户的登录、登出的能力
 *
 * @author lidy
 * @since 2024-05-08
 */
public interface AdminAuthService {

    /**
     * 账号登录
     *
     * @param reqVO 登录信息
     * @return 登录结果
     */
    AuthLoginRespVO login(AuthLoginReqVO reqVO);

    /**
     * 验证用户 账号 + 密码，如果通过，则返回用户信息
     *
     * @param username 用户账号
     * @param password 密码
     * @return 用户信息
     */
    AdminUserDO authenticate(String username, String password);

    /**
     * 基于 token 退出登录
     *
     * @param token   token
     * @param logType 登出类型
     */
    void logout(String token, Integer logType);

    /**
     * 刷新访问令牌
     *
     * @param refreshToken 刷新令牌
     * @return 登录结果
     */
    AuthLoginRespVO refreshToken(String refreshToken);
}
